home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 January / Macworld (1998-01).dmg / Shareware World / Comms & Internet / BetterTelnet / documentation / BetterTelnet Manual next >
Text File  |  1997-09-21  |  19KB  |  271 lines

  1.  
  2. Welcome to...
  3. BetterTelnet 1.2
  4. by Rolf Braun - Sassy Software - copyright 1997 Rolf Braun
  5. e-mail: rbraun@cstone.net
  6. web: http://www.cstone.net/~rbraun/mac/telnet/
  7.  
  8. BetterTelnet is based on NCSA Telnet 2.7b5, which was developed at the National Center for Supercomputing Applications (NCSA) at the University of Illinois at Urbana-Champaign (UIUC).
  9.  
  10. BetterTelnet uses the MD4 and MD5 message digest algorithms from RSA Data Security, Inc.
  11.  
  12. Tab control from Jim's CDEFs by James G. Stout.
  13.  
  14. BetterTelnet is free software under the General Public License (GPL), but is provided with NO WARRANTY whatsoever. See the file COPYING for details.
  15.  
  16. Special thanks to:
  17.  
  18. Olav Brinkmann: code to implement the VT220 show/hide cursor control sequences
  19. Jean-Pierre Kuypers: localizing BetterTelnet in French
  20. Dan Hyde: fixing a couple memory leaks and a translation bug, reverse DNS for Kerberos
  21. Carl Bell: the Keypad/Function picture MDEF
  22. Eric P. Scott: the NextStep translation table
  23. Jim Matthews: helping to fix a bug involving Internet Config and 68000 machines
  24. Andreas Prilop: more translation tables
  25. Brent Schwan: support for boldface ANSI colors, efficiency tweaks
  26.  
  27. WARNING:
  28. As of 1.0 (final), the preferences file format has changed. The current name for the prefs file is “BetterTelnet Prefs2”. DO NOT attempt to rename “NCSA Telnet Preferences” or “BetterTelnet Prefs” files to “BetterTelnet Prefs2” — if you do this, BetterTelnet WILL CRASH!
  29.  
  30. 0. Release Notes
  31.  
  32. Changes from 1.1.1 to 1.2:
  33.  
  34. 1. A really obnoxious bug in the scrollback code from NCSA Telnet has been fixed. The scrollback bug could cause parts of the scrollback to be confused with other parts and end up being duplicated.
  35.  
  36. 2. S/Key and OTP (One-Time Passwords) support.
  37.  
  38. 3. Most dialogs are now movable modal, and the Macros and IP Address dialogs are modeless now.
  39.  
  40. 4. The Terminals and Favorites dialogs are now tabbed.
  41.  
  42. 5. A new checkbox in the Font pane of the Terminals dialog allows you to specify that the boldfaced version of a font should be used for the bold font.
  43.  
  44. 6. The bold font is now saved in sets.
  45.  
  46. Changes from 1.1 to 1.1.1:
  47.  
  48. 1. A bug from 1.1 which prevented the ANSI Colors from being saved into the preferences file has been fixed.
  49.  
  50. Changes from 1.0 to 1.1:
  51.  
  52. 1. A few pixel spacing tweaks have been made to make BetterTelnet look a bit nicer under Mac OS 8.
  53.  
  54. 2. You can now select the boldface font for the current session from the Session menu.
  55.  
  56. 3. The clipping of trailing spaces is now controllable via an option in the Edit/Preferences... dialog. When this new option is on, trailing spaces will always be clipped off each line of a selection being copied, printed, or saved. When it is turned off, this will only be done for multi-line selections.
  57.  
  58. 4. A minor bug in editing Terminals or Favorites has been fixed; you can now change the capitalization of the name without changing the name itself.
  59.  
  60. 5. Brent Schwan's new code for bold ANSI colors has been added, along with some efficiency tweaks.
  61.  
  62. Changes from 1.0fc8 to 1.0:
  63.  
  64. 1. A new option has been added to the File menu allowing the upload of files in plaintext. Note that, to maximize performance, you should set the Paste mode to Quick in Favorites/Edit Favorites... before attempting to upload.
  65.  
  66. 2. You can now save the selection to a text file. Look in the File menu.
  67.  
  68. 3. A reverse DNS lookup is now performed on the remote host when opening a connection if Kerberos authentication is turned on. This allows proper behavior with load-balancing DNS servers and Kerberos. Special thanks to Dan Hyde for the code to implement this.
  69.  
  70. 4. You can now select any font on your system as a boldface font, in addition to the internal “NCSA VT Bold” font. Take a look at Edit/Terminals... for more.
  71.  
  72. 5. You can now tell BetterTelnet, in Edit/Terminals..., to use inverse instead of (or in addition to!) boldfacing.
  73.  
  74. 6. A new command has been added to the Net menu: “Send IP + SYNC”. This sends an Interrupt Process the RFC-compliant way: followed immediately by a SYNC signal.
  75.  
  76. 7. You can now tell BetterTelnet to display only monospaced fonts in the Font menu. See Edit/Preferences... Note that this will increase startup time.
  77.  
  78. 8. The ResEdit TMPL templates have been updated.
  79.  
  80. 9. Added more translation tables. Special thanks to Andreas Prilop.
  81.  
  82. Changes from 1.0fc7 to 1.0fc8:
  83.  
  84. 1. A new button has been added to the Set Macros dialog: "Save as Default". Clicking this button automatically saves the current macros to the "BetterTelnet Macros" file in the Preferences folder.
  85.  
  86. 2. The Ignore Beeps option now has a menu item in the Session menu as well.
  87.  
  88. 3. A new Ignore Form Feeds option has been added to suppress form feeds when printing, allowing more to fit on a page. This option is both in the Session menu AND in the Favorites/Edit Favorites... dialog.
  89.  
  90. 4. Both the Ignore Beeps option and the Ignore Form Feeds option are now saved with saved sets.
  91.  
  92. Changes from 1.0fc6 to 1.0fc7:
  93.  
  94. 1. A bug causing crashes command-clicking URLs on original 68000 machines has been fixed. Note that there still may be other bugs affecting command-clicking URLs on other machines, and there may still be some bugs affecting 68000s.
  95.  
  96. 2. A couple printing-related bugs have been fixed. Specifically, the last character of a print job is no longer clipped off, but NULLs are removed from the print stream.
  97.  
  98. 3. An option has been added under Favorites/Edit Favorites... to allow ignoring beeps.
  99.  
  100. 4. HOpen() calls have been changed to HOpenDF() where appropriate to prevent accidentally opening a driver (the infamous ".Sony" bug).
  101.  
  102. 5. Selections of one line or less no longer have trailing spaces clipped when copying or retyping.
  103.  
  104. Changes from 1.0fc5 to 1.0fc6:
  105.  
  106. 1. A memory leak has been plugged, thanks to Dan Hyde.
  107.  
  108. 2. A bug in the way translation is performed has also been fixed, again thanks to Dan Hyde. This bug was present in NCSA Telnet as well and affected international characters in macros and drag-and-drop.
  109.  
  110. 3. You can now change the boldfacing method used from the Session menu, useful if you switch fonts on the fly.
  111.  
  112. 4. The boldfacing method is now saved in sets.
  113.  
  114. 5. A new item has been added to the Edit menu, "Retype Selection", which retypes the currently selected text. This is similar to a function in NiftyTelnet.
  115.  
  116. 6. TMPLs have been added for PrEf, TeRm, and SeSn resources for the convenience of ResEdit aficionados.
  117.  
  118. 7. A bug has been fixed, present since 1.0fc4, which caused some of the popup menus in the Edit Favorites dialog to not function properly. This was due to a bug in the way ResEdit's DITL editor handles controls, and I had to edit the DITL manually using a template to correct it.
  119.  
  120. Changes from 1.0fc4 to 1.0fc5:
  121.  
  122. 1. A severe bug in the new boldfacing code has been fixed.
  123.  
  124. Changes from 1.0fc3 to 1.0fc4:
  125.  
  126. 1. A new option has been added to Edit/Terminals... for the convenience of emacs users which allows you to map Del (the forward delete key on an extended keyboard) to Control-D.
  127.  
  128. 2. Internal fonts are now referred to by name, not by number, to prevent ID conflicts.
  129.  
  130. 3. In the Session/Size/Other Size... dialog, the font size can now be as low as 4 points, not 9 points.
  131.  
  132. 4. The internal boldface font has been modified so that the zero can be distinguished from the capital letter O ("oh") and the lowercase L from the uppercase I.
  133.  
  134. 5. Boldfacing has been redone. For one thing, previous versions used the internal bold font only if the selected font was Monaco 9. However, other fonts such as Mishawaka 9 had the same spacing and worked fine with the internal bold font. Thus, this is now controlled by the user, via the "Allow boldfacing" checkbox in Edit/Terminals... Also, for fonts which don't get along well with the internal bold font, turning on "Use color for bold" in Edit/Terminals... will cause BetterTelnet to use the blink color for bold as well. Cool, huh?
  135.  
  136. 6. MacTCP and OT are now loaded the first time they are needed, not when BetterTelnet starts up. This allows users on dialup connections to tweak their prefs without dialing up. Note that if the FTP server is turned on, MacTCP/OT will still be loaded at startup, however.
  137.  
  138. 7. Several bugs in Queue Print Requests have been fixed.
  139.  
  140. 8. You can now use a negative port number to force BetterTelnet to send initial option negotiation codes.
  141.  
  142. 9. You can now use BSD 4.3 CR mode on non-port-23 connections by turning on "...even on non-port-23" in Favorites/Edit Favorites...
  143.  
  144. 10. New versions of Carl Bell's Key/Func MDEF have been added.
  145.  
  146. 11. A new translation table for NextStep has been added, courtesy of Eric P. Scott. It is copyrighted 1994 by Eric P. Scott and is used with permission.
  147.  
  148. 12. The "BetterTelnet Macros" file in the Preferences folder can now be an alias.
  149.  
  150. Changes from 1.0fc2 to 1.0fc3:
  151.  
  152. 1. The Session menu has been re-ordered.
  153.  
  154. 2. Certain drain bamaged Telnet hosts don't seem to know how to use the VT220 printing codes. For the record, the way to do it is to send the "Begin Printing" code, spew the whole document out, and then send the "End Printing" code. The way NOT to do it is to send the "Begin Printing" and "End Printing" codes before and after each line. I have added a kludge for these drain bamaged hosts in 1.0fc3. Turn on  "Queue Print Jobs" from the "Session" menu prior to printing; after the host says it's done printing, turn it off again. If any data was spooled, you will be prompted to print the whole thing then.
  155.  
  156. Changes from 1.0fc1 to 1.0fc2:
  157.  
  158. 1. The change from 1.0fc1 regarding Telnet option negotiation codes on ports other than 23 has been removed.
  159.  
  160. 2. A new preference has been added which allows you to automatically open the <Default> favorite whenever you start BetterTelnet.
  161.  
  162. 3. The "Open Connection" box will no longer appear on startup, even if the preference is turned on, if you launch BetterTelnet by opening a saved set file.
  163.  
  164. 4. You can hold down the Option key while selecting Local Echo or Set Screen Size from the Session menu to prevent BetterTelnet from telling the remote host about it.
  165.  
  166. 5. You can hold down the Option key while selecting Save Set or Save Set with Macros from the File menu to prevent BetterTelnet from saving window title, position, and size information.
  167.  
  168. 6. A new preference has been added ("Allow typing of aliases") which allows you to type in the name/alias of a Favorite in the input box in the Open Connection dialog instead of a hostname, like you could in NCSA Telnet.
  169.  
  170. 7. A certain infamous spelling error ("reslover") has been fixed.
  171.  
  172. 8. A patch from Olav Brinkmann has been applied which allows proper recognition and interpretation of the VT220 codes to show and hide the cursor. Thanks, Olav!
  173.  
  174. Changes from 1.0b5 to 1.0fc1:
  175.  
  176. 1. You can now navigate the favorites list while in the Open Connection dialog using the up and down arrow keys.
  177.  
  178. 2. Telnet option negotiation codes will no longer be accepted or sent for any reason on ports other than 23. If this causes any problems, let me know.
  179.  
  180. 3. Some new items have been added to the Session menu: ANSI color sequences, Xterm sequences, 8-bit connections, Remap Keypad.
  181.  
  182. 4. You can no longer crash BetterTelnet by attempting to open a Favorite with a null hostname. You will now see an alert instead.
  183.  
  184. 5. You can now save sets directly from the Favorites dialog with macros by holding down the Option key while clicking "Save Set..."
  185.  
  186. 6. You can no longer confuse BetterTelnet and cause the prefs file to be corrupted by attempting to create two Favorites or Terminals with the same name but different case. (<Default> and <dEfAuLt>, for example)
  187.  
  188. 7. If you export the macros to a file called "BetterTelnet Macros" in the Preferences folder, they will be loaded automatically whenever you start BetterTelnet.
  189.  
  190. Changes from 1.0b4 to 1.0b5:
  191.  
  192. 1. You can now save multi-session sets directly from the Edit Favorites dialog box. To do this, use the "Save Set" button to save the first session, then use the "Add to Set" button for subsequent sessions; you will need to select the existing set file. The set file will then open all sessions saved when double-clicked.
  193.  
  194. 2. Sets saved from the Edit Favorites dialog now save local echo and half duplex information.
  195.  
  196. 3. A bug has been fixed which allowed the user to resize the window to more than 132 columns by option-dragging the size box. Previously, attempting to exceed 132 columns in this manner could cause odd behavior or a crash. Now, window resizes with option-size are constrained to 132 columns, just like resizes done with Session/Set Screen Size.
  197.  
  198. 4. Quitting BetterTelnet now asks you to confirm the quit if you have any active sessions open. This behavior can be turned off with the new "Don't warn me on quit" preference.
  199.  
  200. Changes from 1.0b3 to 1.0b4:
  201.  
  202. 1. You can now save single-session sets directly from the Edit Favorites dialog box. These sets are saved complete with terminal information from the currently selected Terminal entry and pretty much everything else except for macros. Note that local echo and half duplex aren't currently saved in any set; this will be fixed soon.
  203.  
  204. 2. The "Save Set" option in the File menu now saves sets without macros. You can select "Save Set with Macros" to save with macros.
  205.  
  206. 3. A bug has been fixed which caused the "Next Session" item to revert to the English text "Next Session" after closing the Preferences dialog box even if the application's resources have been localized. This showed up in Jean-Pierre Kuypers' French translation. Localized resources now work as expected.
  207.  
  208. 4. A bug has been fixed which caused certain items in saved sets (PgUp and Keypad mapping, as well as linemode and 8-bit mode) to not be loaded correctly. This bug also caused multi-session saved sets to not be loaded correctly.
  209.  
  210. Changes from 1.0b2c2 to 1.0b3:
  211.  
  212. 1. A couple of the dialogs look nicer now.
  213.  
  214. 2. Saved Sets now save MUCH more information. This is in preparation for further enhancements to Sets (such as the ability to save directly from the Favorites Edit dialog box). New information includes: emulation type, forcesave, VT wrap mode, Xterm sequences, ANSI color, EMACS arrow mapping, EMACS meta key, paste method, paste block size, and clear screen saves lines. You will not be able to open sets saved from BetterTelnet 1.0b3 or later with NCSA Telnet or previous versions of BetterTelnet anymore.
  215.  
  216. 3. 68k version now compiled with 68020 codegen turned OFF, so it will run on an original 68000.
  217.  
  218. Changes from 1.0b1c4 to 1.0b2c2:
  219.  
  220. 1. Now linked with the Internet Config 1.3 library, and the URL command-click code has been revised to use the new Internet Config 1.1 API. You will encounter problems trying to command-click URLs with versions of Internet Config prior to 1.1 installed. Please note that BetterTelnet doesn't require Internet Config; it is only needed to command-click URLs.
  221.  
  222. 2. You can now change the CR mapping method (normal or BSD) during a session with the Session menu.
  223.  
  224. 3. Options have been added to the Net menu allowing you to send BREAK and SYNC signals to the remote computer over the Telnet connection.
  225.  
  226. Changes from NCSA Telnet 2.7b5 to BetterTelnet 1.0b1:
  227.  
  228. 1. Connecting to non-port-23 hosts no longer sends initial option negotiation codes. This prevents the first line you type from getting garbled. To test this, connect to "madlab.sprl.umich.edu 3000" (type that in the Host Name box, without the quotes) and type DCA when asked for a city code. If you are using BetterTelnet, you will get the weather forecast for Washington DC. Under NCSA Telnet, any version, you will get a "no data available" error; you then have to type DCA at the next prompt. This is a serious bug fix! Note that, except in 1.0fc1 (which was broken), BetterTelnet will still properly recognize & interpret incoming option negotiation codes, so you can still connect to genuine Telnet servers on ports other than 23. As of 1.0fc4, specifying a negative port number will open the absolute value of that port number but send initial option negotiation codes anyway in case the server expects them.
  229.  
  230. 2. Connections to non-port-23 hosts have Berkeley 4.3 CR mode turned off automatically, even if it is turned on in the preferences. As of 1.0fc4, you can override this by turning on "...even on non-port-23" right below the option for Berkeley CR mode in the Favorites/Edit Favorites... dialog.
  231.  
  232. 3. New Interface! The prefs have been re-organized a bit, and the Favorites menu now replaces the Open Special submenu of the File menu. Names of Favorites (formerly Sessions) can now contain spaces. You can no longer enter a favorite name ("alias") in the input box in the Open Connection dialog; use the pop-down menu or the Favorites menu instead.
  233.  
  234. 4. You can now use a colon (:) instead of spaces to delimit port numbers. Thus, "madlab.sprl.umich.edu:3000" is equivalent to "madlab.sprl.umich.edu 3000"
  235.  
  236. 5. The window title now includes the port number if it isn't 23.
  237.  
  238. 6. The pop-down box in the Open Connection dialog works differently now. A check mark in this menu indicates that the settings from that Favorite will be used (<Default> is checked by default); selecting an item from this menu puts a check mark by that item and enters the host name/port and authentication data from that Favorite's settings.
  239.  
  240. 7. You can now automatically open the Open Connection dialog on startup. See the preferences for details.
  241.  
  242. 8. Other small bugs have been fixed.
  243.  
  244. 1. Basic Operation
  245.  
  246. 1.1 Quick Start
  247.  
  248. To open a connection, select “Open Connection” from the File menu. In the “Host Name” box, type the name of the host to which you want to connect, optionally followed by a colon (:) and the port number. The other options are discussed in more detail elsewhere in this manual.
  249.  
  250. 1.2 Features of the VT220 Emulator
  251.  
  252. BetterTelnet implements an almost-complete VT220 emulator. Most features are implemented, except for double-high and double-wide characters. ANSI color sequences, as well as the Xterm sequences to change the window title, are both fully supported.
  253.  
  254. BetterTelnet also implements a Tektronix emulator for plotted vector graphics, as well as an Interactive Color Raster (ICR) graphics system for bitmapped graphics.
  255.  
  256. For more information on the Tektronix (TEK) emulator, see the following web page:
  257.  
  258. http://www.ncsa.uiuc.edu/SDG/Software/MacTelnet/Docs/MacTelnet5_1.html
  259.  
  260. For more information on the ICR graphics system, see the following web page:
  261.  
  262. http://www.ncsa.uiuc.edu/SDG/Software/MacTelnet/Docs/MacTelnet6_1.html
  263.  
  264. ...or, take a look at the icrtest.c source code file in the “Goodies” directory of the BetterTelnet documentation package.
  265.  
  266. Handy Tip: Look for these Handy Tips throughout the manual to increase your productivity in BetterTelnet!
  267.  
  268. Handy Tip: While resizing the terminal window simply resizes your view onto the actual screen, you can resize the virtual screen itself by holding down the Option key while dragging the size box. You can also do this by selecting Session/Set Screen Size...
  269.  
  270. Handy Tip: You can option-click on a position in the terminal window to move the cursor to that position. This will work only if the remote host interprets the correct arrow key sequences as expected (for example, in a text editor), and if the cursor is in the correct position to begin with.
  271.